home *** CD-ROM | disk | FTP | other *** search
/ QRZ! Ham Radio 8 / QRZ Ham Radio Callsign Database - Volume 8.iso / mac / files / sat / sat04aug.exe / SATELLIT.ENG < prev    next >
Text File  |  1994-08-04  |  8KB  |  220 lines
  1. Documentation for SATELLIT.EXE
  2. -------------------------------
  3. DISTRIBUTION/COPYRIGHT
  4. -----------------------
  5. The present program is designed for evaluation purposes only. It provides
  6. full functionality until the date which is presented on the starting screen.
  7. After this date the calculation procedure does not work correctly!!!
  8. The software package with all necessary files is freely distributable. It is
  9. not allowed to change this short documentation.
  10.  
  11. 1. Program Parameters
  12.  
  13. * up to 255 different satellites
  14. * using AMSAT and NORAD format
  15. * optional calculation of AOS (Appearance Of Satellite) and maximum elevation
  16. * optional acustic signal triggered by AOS/LOS
  17. * prediction protocol to textfile
  18. * prediction also for two sites
  19. * locator-coordinate-distance computation
  20. * worldmap with spotlight
  21. * azimuth-/elevation graphic with optional presentation of horizon
  22. * information system for particular satellites
  23. * bi-lingual (English and German)
  24. * all data files are text-type files
  25. * selecticve update of element sets when using NORAD format
  26. * display of the sun terminator
  27.  
  28. * minimum configuration:
  29.             * PC-AT 286 and above
  30.             * abt. 200kByte disc capacity
  31.             * abt. 400kByte free memory when using graphics
  32.             * EGA/VGA-graphic
  33.  
  34. * optional:
  35.             * Arithmeticprocessor
  36.             * Mouse
  37.  
  38. 2. Program Description
  39.  
  40. The program allows to track up to 255 satellites. The tracking is done
  41. eigther in real-time or in the delta-t mode. 16 satellites are presented
  42. simultaneously in the real time table.
  43.  
  44. The program is controlled by means of the following keys:
  45.  
  46.  
  47. <Esc>
  48.             The Escape-key is the most important key in the program, for it
  49.             helps (almost) every time to abort the working function.
  50.  
  51. <ENTER>
  52.             <ENTER> confirms the selected menu items and starts the corres-
  53.             ponding actions.
  54.  
  55. <CNTRL><ENTER>
  56.             This key combination starts the azimuth-/elevation-diagram for
  57.             the selected satellite.
  58.  
  59. <CNTRL>S
  60.             ^s activates the satellite search function. Its quite useful if
  61.             a large number of satellites was loaded. It is not necessary to
  62.             use the full name.
  63.  
  64. Page up/down
  65.             Browses through the satellite list.
  66.  
  67. Cursor-Keys
  68.             Selects satellites or menu items, respectively.
  69.  
  70. The following keys help to control the graphic displays:
  71.  
  72. <TAB>       Toggles between the world map and the horizon display.
  73.  
  74. Page up/down
  75.             Browses through the satellites.
  76.  
  77. Cursor-Keys
  78.             Control the mouse pointer.
  79.  
  80.  
  81. It is possible to activate menu items with "hotkeys". Menu items which
  82. require a satellite as parameter, refer to the selected satellite.
  83.  
  84. Nevertheless we have tried to design the program interface as easy as
  85. possible so that you simply should test it out.
  86.  
  87. Files:
  88.  
  89. SATELLIT.EXE uses several data files. All these files can be changed by
  90. the user.
  91.  
  92. SATELLIT.EXE
  93.             The program itself :-)
  94. SATELLIT.INI
  95.             Setup file. It is self-explaining. If this file does not exist
  96.             it is automatically generated by the program.
  97.             One new feature was added - multi satellite tracking. If a
  98.             sequence of satellites is specified the program browses through
  99.             this sequence, if you are in world map mode.
  100. ELEMENTE.DAT
  101.             This file contains the Keplerian data sets of the particular
  102.             satellites. If it contains more than 255 satellites it ignores
  103.             the remaining ones.
  104.             It is possible to use the NORAD-format as well as the
  105.             AMSAT-format. If you get your files from a BBS it is not
  106.             necessary to edit. The program ignores any stuff which does
  107.             not look like data.
  108.  
  109.             IMPORTANT:
  110.         We added a new feature. It is now possible to update element sets
  111.         automatically. To do this use the following procedure:
  112.  
  113.              - choose the 'Information' item for the particular satellite
  114.              - choose 'Update'
  115.              - type the name of the file which contains the new elment set
  116.                for the particular satellite
  117.              - hope that all is ok :-)
  118.  
  119.             NOTE:
  120.             To use the above described feature it is necessary to use 
  121.             NORAD/NASA format for element sets for the specified satellite.
  122.             It does NOT work with AMSAT-format.
  123.             You can only update but not add new ones. For an update of all
  124.             satellites it is more convinient to replace the whole file but
  125.             for tracking STS or MIR the selective update obviously has some
  126.             advantages. 
  127.  
  128.  
  129. WELT.MAP
  130.             This file contains data for the world map. Its not quite detailed
  131.             yet but everybody can improve it. (128 objects are allowed)
  132. LAKES.MAP
  133.             Similiar to welt.map. It contains data of larger lakes.
  134. SATMODE.DAT
  135.             This file is used for mode control. Please see the example.
  136. UMGEBUNG.DAT
  137.             In this file everybody can put his horizon-shape. So you know
  138.             the reason why you do not hear the satellite although it has
  139.             a 50° elevation...
  140.  
  141. SATINFO.TXT/SATINFO.ENG
  142.             Here you can store all information about particular satellites.
  143.             The involved editor is Wordstar-compatible.
  144.         When using English output SATINFO.ENG is involved otherwise
  145.             SATINFO.TXT.
  146.  
  147. 3. Additional advices - Forecast
  148.  
  149. If the program seems to be slow then try a Coprocessor. It improves the
  150. performance quite a lot.
  151. We did not implement a print-out function yet, although you have the
  152. corresponding item in the program. If someone wants to print the results he
  153. can do that be using the text file protocolling. The text file can be printed
  154. out be the normal DOS print-command.
  155. There are two several sounds to signal the appearance or the loose of a
  156. satellit. Morse code "K" -.- means a satellite just appeared and Morse code
  157. "SK" ...-.- that it disappeared.
  158. On the graphics displays the doppler shift is computed. Thats the shift in
  159. frequency caused by the relativ velocity between ground station and satellite.
  160. Its useful to find your downlink signal quickly. But you have to take into
  161. account whether you are using an inverting or a non inverting transponder.
  162.  
  163.  noninverting: downlink frequency :=    downlink frequency (theoretical)
  164.                                        + uplink shift
  165.                                        + downlink shift
  166.  
  167.  inverting   : downlink frequency :=    downlink frequency (theoretical)
  168.                                        + uplink shift
  169.                                        - downlink shift
  170.  
  171. Inverting transponders compensate the Doppler shift a bit. OSCAR 13 uses
  172. an inverting transponder, RS-10 and RS-12 use non inverting transponders.
  173.  
  174.  
  175. What brings the future?
  176.  
  177. Obviously it is necessary to implement a rotor control. Hopefully, this will
  178. be done in the near future.
  179. The AOS-computation will be done analytically in the next versions.
  180.  
  181. We spent a lot (some hundreds) of hours designing this program. Nevertheless
  182. it certainly will contain some bugs. So if you fix any problems it would be
  183. very kind of you to give us a message.
  184.  
  185. If you like the program and want to get a full version then simply contact
  186. us for further information. The fastest way is e-mail...
  187.  
  188. Here are the ways to contact us:
  189.  
  190. 1.) DL3HRT                  AX25:         DL3HRT@DB0LPZ.#SAX.DEU.EU
  191.     Karsten Hansky          e-mail:       hansky@igel.physik.th-zwickau.de
  192.     August-Bebel-Str.14           
  193.     06712 Kretzschau
  194.     GERMANY
  195.  
  196. 2.) DL3HZM              AX25:         DL3HZM@DB0LPZ.#SAX.DEU.EU
  197.     Matthias Mitte          e-mail:       e3daq@mlucom.urz.uni-halle.de
  198.     Wiesenstraße 3
  199.     06712 Zeitz
  200.     GERMANY
  201.  
  202. The price for a full version is US $10 if you get the copy by internet. To
  203. get it by mail additional US $5 are required.
  204.  
  205. The best way is to transfer the money to the following account:
  206.  
  207. DEUTSCHE BANK Filiale Zeitz
  208. BLZ: (code of the bank)    86070000
  209. Kto-Nr.: (code of account) 6715296
  210.  
  211.  
  212. Have a lot of fun!!!
  213.  
  214. DL3HRT, DL3HZM & DE2HAW.
  215.  
  216.  
  217. PS: The latest version is always available via Internet by anonymous ftp to:
  218.         igel.physik.th-zwickau.de
  219.  
  220.